ETAPI는 외부 프로그램에서 Trilium을 사용하는 REST API입니다. 0.50부터 제공됩니다. 명세는 OpenAPI 문서에서 확인할 수 있습니다.

클라이언트 라이브러리

trilium-py를 사용하면 Python에서 Trilium에 접근하는 코드를 더 쉽게 작성할 수 있습니다.

토큰 발급

모든 API 작업은 토큰으로 인증해야 합니다. 설정 → ETAPI에서 발급하거나 /auth/login 요청으로 받을 수 있습니다. 자세한 요청 형식은 API 명세를 참고하세요.

인증

Authorization 헤더

GET https://myserver.com/etapi/app-info
Authorization: ETAPITOKEN

ETAPITOKEN을 발급받은 토큰으로 바꾸세요. 0.93.0부터는 다른 도구와의 호환성을 위해 Bearer ETAPITOKEN 형식도 지원합니다.

기본 인증

0.56부터 다음 형식도 지원합니다.

GET https://myserver.com/etapi/app-info
Authorization: Basic BATOKEN

• BATOKEN = BASE64(username + ':' + password) 형식으로 만듭니다.
• 사용자 이름은 etapi입니다.
• 비밀번호 자리에 발급받은 ETAPI 토큰을 넣습니다.

기본 인증만 지원하는 도구에서 사용할 수 있는 방식입니다.

Bash 스크립트 예제

다음 예제는 노트의 HTML 본문을 내려받습니다.

#!/usr/bin/env bash

# 연결 설정
TOKEN=YOUR_ETAPI_TOKEN
SERVER=http://localhost:8080

# 노트 ID로 본문 내려받기
NOTE_ID="i6ra4ZshJhgN"
curl "$SERVER/etapi/notes/$NOTE_ID/content" -H "Authorization: $TOKEN" 

실행 전에 다음 값을 바꾸세요.

• TOKEN — 직접 발급받은 ETAPI 토큰
• SERVER — 사용 중인 Trilium의 프로토콜과 호스트 및 포트
• NOTE_ID — 내려받을 노트의 ID